home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Vk / VkMenuConfirmFirstAction.z / VkMenuConfirmFirstAction
Encoding:
Text File  |  2002-10-03  |  8.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. VVVVkkkkMMMMeeeennnnuuuuCCCCoooonnnnffffiiiirrrrmmmmFFFFiiiirrrrssssttttAAAAccccttttiiiioooonnnn((((3333xxxx))))                      VVVVkkkkMMMMeeeennnnuuuuCCCCoooonnnnffffiiiirrrrmmmmFFFFiiiirrrrssssttttAAAAccccttttiiiioooonnnn((((3333xxxx))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      VkMenuConfirmFirstAction - A menu action that requires user confirmation
  10.  
  11. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  12.      VkMenuAction : VkMenuItem : VkComponent : VkCallbackObject
  13.  
  14. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  15.      #include <Vk/VkMenuItem.h>
  16.  
  17. PPPPUUUUBBBBLLLLIIIICCCC PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLL SSSSUUUUMMMMMMMMAAAARRRRYYYY
  18.    CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr////DDDDeeeessssttttrrrruuuuccccttttoooorrrr
  19.            VkMenuConfirmFirstAction(const char    *name,
  20.                                     XtCallbackProc doitCallback,
  21.                                     XtPointer      clientData);
  22.            VkMenuConfirmFirstAction(const char *name,
  23.                                     XtCallbackProc doitCallback,
  24.                                     XtCallbackProc undoCallback ,
  25.                                     XtPointer clientData);
  26.            ~VkMenuConfirmFirstAction();
  27.  
  28.  
  29.    MMMMaaaannnniiiippppuuuullllaaaattttiiiinnnngggg MMMMeeeennnnuuuu IIIItttteeeemmmmssss
  30.            virtual void undo();
  31.  
  32.  
  33.    AAAAcccccccceeeessssssss FFFFuuuunnnnccccttttiiiioooonnnnssss
  34.            virtual const char* className();
  35.            virtual VkMenuItemType menuType();
  36.            Boolean hasUndo()
  37.  
  38.  
  39. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.      This class supports menu actions (See VkMenuAction(3X)) that require user
  41.      confirmation before being executed. This class is used exactly the same
  42.      as VkMenuAction, but when a user selects a VkMenuConfirmAction menu item,
  43.      the ViewKit posts a confirmation dialog before executing the command.
  44.      Only if the user selects the dialog's OK button is the command actually
  45.      executed.
  46.  
  47.           The question displayed in the confirmation dialog os determined by
  48.           the value of a resource "noUndoQuestion", which is retrieved
  49.           relative to the menu item. If no value is set of this resource the
  50.           question defaults to a generic English-language question. For
  51.           example, assume an action named "quit", added as follows:
  52.  
  53.  
  54.             aMenuPane->addConfirmFirstAction("quit", quitApplication, NULL);
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VVVVkkkkMMMMeeeennnnuuuuCCCCoooonnnnffffiiiirrrrmmmmFFFFiiiirrrrssssttttAAAAccccttttiiiioooonnnn((((3333xxxx))))                      VVVVkkkkMMMMeeeennnnuuuuCCCCoooonnnnffffiiiirrrrmmmmFFFFiiiirrrrssssttttAAAAccccttttiiiioooonnnn((((3333xxxx))))
  71.  
  72.  
  73.  
  74.           An application could specify a resource in the application's app-
  75.           defaults file like this:
  76.  
  77.  
  78.           *quit.noUndoQuestion: Do you really want to quit?
  79.  
  80.  
  81.  
  82. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  83.    VVVVkkkkMMMMeeeennnnuuuuCCCCoooonnnnffffiiiirrrrmmmmFFFFiiiirrrrssssttttAAAAccccttttiiiioooonnnn
  84.            VkMenuConfirmFirstAction(const char *name,
  85.                                     XtCallbackProc doitCallback,
  86.                                     XtPointer clientData);
  87.            VkMenuConfirmFirstAction(const char *name,
  88.                                     XtCallbackProc doitCallback,
  89.                                     XtCallbackProc undoCallback,
  90.                                     XtPointer clientData);
  91.  
  92.  
  93.           Initialize an instance of VkMenuConfirmAction.
  94.  
  95.    ~~~~VVVVkkkkMMMMeeeennnnuuuuCCCCoooonnnnffffiiiirrrrmmmmFFFFiiiirrrrssssttttAAAAccccttttiiiioooonnnn
  96.            ~VkMenuConfirmFirstAction();
  97.  
  98.  
  99.           Clean up.
  100.  
  101.    MMMMaaaannnniiiippppuuuullllaaaattttiiiinnnngggg MMMMeeeennnnuuuu IIIItttteeeemmmmssss
  102.            virtual void undo();
  103.  
  104.  
  105.    ccccllllaaaassssssssNNNNaaaammmmeeee
  106.            virtual const char* className();
  107.  
  108.  
  109.           Returns "VkMenuConfirmFirstAction".
  110.  
  111.    mmmmeeeennnnuuuuTTTTyyyyppppeeee
  112.            virtual VkMenuItemType menuType();
  113.  
  114.  
  115.           Returns VkMenuItem::CONFIRMFIRSTACTION.
  116.  
  117.  
  118.            Boolean hasUndo()
  119.  
  120.  
  121.           Returns TRUE if an undoCallback has been registered.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. VVVVkkkkMMMMeeeennnnuuuuCCCCoooonnnnffffiiiirrrrmmmmFFFFiiiirrrrssssttttAAAAccccttttiiiioooonnnn((((3333xxxx))))                      VVVVkkkkMMMMeeeennnnuuuuCCCCoooonnnnffffiiiirrrrmmmmFFFFiiiirrrrssssttttAAAAccccttttiiiioooonnnn((((3333xxxx))))
  137.  
  138.  
  139.  
  140. EXAMPLES
  141. IIIINNNNHHHHEEEERRRRIIIITTTTEEEEDDDD MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  142.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkMMMMeeeennnnuuuuAAAAccccttttiiiioooonnnn
  143.             undo(),  hasUndo(),  _undoCallback, _func,  _data,
  144.  
  145.  
  146.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkMMMMeeeennnnuuuuIIIItttteeeemmmm
  147.           show(), hide(),, manageAll(), setLabel(), setPosition(), activate(),
  148.           deactivate(), remove(), show(), isContainer(), _position, _isBuilt,
  149.           _sensitive, _parentMenu, _label, _isHidden, _unmanagedWidgets,
  150.           _numUnmanagedWidgets,
  151.  
  152.  
  153.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkCCCCoooommmmppppoooonnnneeeennnntttt
  154.           installDestroyHandler(), removeDestroyHandler(), widgetDestroyed(),
  155.           setDefaultResources(), getResources(), manage(), unmanage(),
  156.           baseWidget(), okToQuit(), _name, _baseWidget, _w, deleteCallback
  157.  
  158.  
  159.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkCCCCaaaallllllllbbbbaaaacccckkkkOOOObbbbjjjjeeeecccctttt
  160.           callCallbacks(), addCallback(), removeCallback(),
  161.           removeAllCallbacks()
  162.  
  163.  
  164. CCCCLLLLAAAASSSSSSSSEEEESSSS UUUUSSSSEEEEDDDD BBBBYYYY TTTTHHHHIIIISSSS CCCCLLLLAAAASSSSSSSS
  165.      VkDialogManager
  166.  
  167. KKKKNNNNOOOOWWWWNNNN CCCCLLLLAAAASSSSSSSSEEEESSSS TTTTHHHHAAAATTTT UUUUSSSSEEEE TTTTHHHHIIIISSSS CCCCLLLLAAAASSSSSSSS
  168.      VkMenu
  169.  
  170. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  171.      VkMenuAction, VkMenuItem, VkComponent, VkDialogManager, VkMenu
  172.      _V_i_e_w_K_i_t _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e
  173.      _T_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m, DEC Press, Bob Sheifler and Jim Gettys
  174.      _T_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m _T_o_o_l_k_i_t, DEC Press, Paul Asente and Ralph Swick
  175.      _T_h_e _O_S_F/_M_o_t_i_f _P_r_o_g_r_a_m_m_e_r_s _R_e_f_e_r_e_n_c_e, Prentice Hall, OSF
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.